home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / sound / signldtr.sit / SignalEditor doc 1.21 < prev    next >
Encoding:
Text File  |  1990-01-16  |  6.7 KB  |  103 lines  |  [TEXT/ttxt]
  1. SignalEditor Documentation: 
  2.  
  3. This program is SHAREWARE.  I don't care if you just have it hanging around, but if you find it useful, be considerate and send $35.00 to make me feel good.  You will note that I have not disabled any features or added an expiration date.  
  4.  
  5. I can be contacted at:
  6.  
  7. Stephen Knight
  8. c/o JSR Synergetics
  9. 1115 East Main St.
  10. Rochester, NY 14609 
  11.  
  12. or CompuServe:     76377, 52 
  13.  
  14. ---------- 
  15.  
  16. Version 1.21 Info, January 16, 1990:
  17. Previously released version:  1.2
  18.  
  19. ----- Differences between the previously released version and this one: -----
  20.  
  21.     Shift left/right:
  22.       - Now deals with selected portions in a more civilized manner (ie: correctly).
  23.       - The problem with shifting when sample #0 has been displayed has been fixed.
  24.  
  25.     Zoom in/out:
  26.       - Selected areas remain selected when zooming in and out.
  27.  
  28.     Waveform selection:
  29.       - The time indicators now follow the mouse as portion of the signal is selected.
  30.       - It is no longer possible to select a nonexistant portion of the signal.  This problem occurred when the signal had been shifted to the left and the end of the signal was visible.
  31.  
  32.     Waterfall display:
  33.       - The new scale factor is 0.10, instead of 1.0.  This will not effect a user much since this is a response to other changes in FFT computations. 
  34.  
  35. ---------- 
  36.  
  37. Version 1.2 Info, January 11, 1990:
  38. Previously released version:  1.0
  39.  
  40. ----- Differences between the previously released version and this one: -----
  41.  
  42.     Waterfall display:
  43.         -  The waterfall spectal display now deals with hidden lines in a more acceptable fashion (ie: they are now produced in "publishable" form).
  44.         -  The waterfall spectral function can be canceled with Command-period.
  45.  
  46.     New functions:
  47.         -  The new function 'Extract' exists under the 'Edit' menu.  When selected, 'Extract' will copy the selected portion of the current signal area into a new file.  This allows the user to create new files with only a portion of the original, yet not have to go thru the hassle of cutting the preceding or subsequent portions of the file to get the desired section
  48.  
  49.     Other modifications:
  50.         -  The left and right arrow keys will scroll you thru the signal faster than before.  Previously, the arrow keys scrolled at 1/10th the displayed signal per keystroke.  Now it will scroll at 1/4th (which seems far more acceptable).
  51.         -  File i/o efficiency has been improved allowing for less time occupied with opening and closing (the bad news is:  floppy i/o is still slow).
  52.         -  "Zoom" (in and out) and "Magnification" no longer needs a wave area to be selected.  It immediately operates on the most recently selected wave area (like cut/copy/paste etc.).
  53.         -  Command-keys have been added to most of the pulldown-menus.  To provide for a bit more mnemonic styling, this entailed shifting some of the command keys to new positions/meanings (Sorry).
  54.  
  55.   ***** NOTE *****  While not all menu items have command-keys associated with them, they will function if you give them one.  Please, if you do decide to change the command keys around, be careful and be aware of command-key limitations (if you don't know what I'm referring to...don't try it).
  56.  
  57.     Dead bugs:
  58.         -  When dealing with a MacRecorder file digitized at 7500Hz, SignalEditor v1.0 would set the sampling rate at 7333Hz.  This problem has been corrected.
  59.         -  A window update problem occurring after a file has been closed has been fixed.  This bug appeared when a spectral window was first opened.
  60.  
  61. ----- End of changes -----
  62.  
  63. Online HELP:  Look under the 'About SignalEditor' for more of an explanation as to what the program is capable of doing.  Also, the 'Settings' item under the 'Spectrum' menu has a help function that can give specific information as to what you would be setting. 
  64.  
  65. ---------- 
  66.  
  67. Some answers to the inevitable questions: 
  68.  
  69. "The version I have complained about being a Mac II or later version" 
  70.  
  71. Ñ I have two versions (SignalEditor and SignalEditor II) that should be traveling together.  One is for the Mac II series or later, and uses code for the 68020/68881 (or later) processors.  If you have the wrong one, check with your source.  If you don't have any luck, check macserve@pucc or CompuServe (the better bet). 
  72.  
  73. ---------- 
  74.  
  75. "It seems to spend a lot of time accessing the disk when opening and closing the file and cut/paste/copy seems to do alot too." 
  76.  
  77.     The problem with editing signals comes from a choice between speed and the number of samples that fit into memory.  I could have made the program try to load in ALL the samples when editing a signal, this would have made the program extremely fast.  Unfortunately, there is always going to be the case of too many samples, so you would only be able to work with files that had fewer samples than you had memory.
  78.  
  79.     I decided to compromise.  The program only keeps the samples in memory that it needs at one time (currently 50K samples).  The rest are kept in a temporary file until needed.  When asked to display more samples (like a signal 60K samples long), it cheats and only shows the first 50K samples of the area selected.  Since the samples are primarily on disk, cut/paste/copy do a very brute force shifting of the necessary samples to/from their appropriate spot.  It may be crude, but it seems to work.  When I figure out a better way, I'll be sure to put it in, but so far everything I've thought of has had some nasty drawbacks. 
  80.  
  81. ---------- 
  82.  
  83. "Ok, so it only displays a certain amount.  How do I get at the rest of it?" 
  84.  
  85.     To get around the problem, I implemented two keystrokes that let you scroll through the signal (albeit slowly).  They are, the LEFT ARROW and RIGHT ARROW keys.  Each time you hit one, the current signal area in use will scroll the signal, either left or right, by approximately 25%.  The larger the amount of time displayed, the greater the scrolling effect. 
  86.  
  87. ---------- 
  88.  
  89. "When I do the waterfall spectrogram or spectral slices on my SE/Mac+, it goes very slowly." 
  90.  
  91.     While my FFT routine is not the fastest, none are very quick.  When it comes to signal processing, horsepower is a vital neccessity. 
  92.  
  93. ---------- 
  94.  
  95. "There's a bug here, now what?" 
  96.  
  97. Although there are bound to be some 'features' that people don't like, I will try to compromise if enough registered users complain.     If it is a bug, please send me a description, with as much technical detail as possible.  I can be reached through the information on the 'About...' dialogs.  If I can eliminate it, I promise to send you a new version, hopefully without the bug. 
  98.  
  99. ---------- 
  100.  
  101. "How about..." 
  102.  
  103. If it doesn't look too bad to implement, sure.  Warning:  I might not have any idea how to implement it, so you might have to explain how (slowly).  An ongoing dialog with registered users will insure improvement and expanded utility in future releases.